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About the Disk 


D CODE IS (as they say) POWERFUL 

D CODE is a collection of three sophisticated machine language programs 
designed to help the Applesoft programmer work more efficiently. 

COMPACT makes your programs take up less space. COMPARE analyzes 
differences between programs. D.BUG adds new commands to your keyboard 

vocabulary, and makes finding those elusive bugs easier and — who knows? 

maybe even fun! 

D CODE IS DOS 3.3 AND ProDOS™ COMPATIBLE 
All D CODE programs come in two versions— one set for working under DOS 
3.3 and another set for ProDOS— both on the same side of the D CODE disk. 
DONT BOOT THE D CODE DISK if you want the DOS 3.3 version of 
D CODE (see page 4 for more info). 


BACK UP YOUR DISK 

Like all Beagle Bros disks, D CODE is not copy protected, just copyrighted. 
Before you get too deeply involved, make a copy of the D CODE disk, using 
the copy program that came with your Apple (like DOS 3.3's COPYA or 
ProDOS's FILER or the Apple lie System Utilities disk). 

At Beagle Bros, we avoid copy-protection so our programs will be more 
friendly to work with, and therefore more valuable to you, the purchaser. 
Please don’t give copies of our software away. Every illegal copy you see is a 
vote AGAINST friendly software and FOR copy protection and higher prices. 
You support us, and we’ll support you. 

BACK UP YOUR PROGRAMS 

Please SAVE your original programs on disk and LOCK them before using 
it first, under a new name, just in case it doesn’t survive the trip. This tip 
applies mostly to programs that have been altered with COMPACT. 


WELCOME, BEGINNERS 

D CODE is for the semi-experienced Applesoft programmer. If terms like 
“DOS”, ’’BRUN’’ and “program line” don’t make sense to you, you may want 
to do some more reading in your Apple manuals before moving on. Actually, 
just remembering to periodically make backups of your programs will rescue 
you from any serious problems. (Also see “Beginner's DOS Note" on page 5.) 
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D CODE Summary 
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To COMPACT an Applesoft Program (page 6) 

1. l^oad your program from your disk. 

2. Insert the D CODE disk, and type “BRUN COMPACT’. g 

3. Select the features you want. - - 

4. Type “C”. 

(To use COMPACT again while it’s still loaded, type 


To COMPARE Files (page i7) 

1. Insert the D CODE disk, and type “BRUN COMPARE”. 

2. Type the name of two same-type (Applesoft, Text, etc.) files you want to compare. 
(To use COMPARE again while it’s still loaded, type "&”.) 


De-Bugging Functions (D.BUG) (page 2 i) 

Insert the D CODE disk, and type "BRUN D.BUG” to install the following new 
commands (single-letter abbreviations, in parentheses): 

BREAK lets you set up program breakpoints (page 34). 

CHECK (C) proofreads a program (page 24). 

DUMP (D) lists the last statements used before a program crash (page 32). 
FIND (F) finds all occurrences of a word in a program (page 22). 

L lists a program (page 25). 

NOTRACE (N) turns off all TRACE functions (page 26). 

TRACE (T) turns on the trace and function (page 26). 

VARIABLES (V:) sets up variables and expressions to be TRACEd (page 26). 
WINDOW (W) lets you pre-adjust the size of the TRACE window (page 26). 
SIZE (S) lets you set the buffer size for DUMP (page 32). 

ZAP (Z) clears the DUMP buffer (page 32). 
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The D CODE Catalog 

The D CODE disk has two sets of programs on It— one for Apple’s older 

DOS 3.3 and another for the newer ProDOS. Both disk catalogs are nearly 

identical, with the ProDOS version containing three extra files— PRODOS, 

BASIC.SYSTEM and FP. Here is a rundown of the main files on the disk: 

STARTUP is the greeting program that displays the main disk menu when 
you boot the disk. Since you can’t boot the disk in DOS 3.3 (see next 
page), you will need to type "RUN STARTUP" to see this program. 

TITLE is the machine-language program that does the crazy text title routine 
at the beginning of STARTUP. 

COMPACT (page 6) packs Applesoft programs to the smallest possible size by 
removing Rem statements, shortening variable names and combining 
program lines. 

LINE.SPLITTER (page 15) lets you chop an Applesoft program line in two, in 
case COMPACT (above) left you with a line that is too long to edit. 

COMPARE (page 17) lets you compare two Applesoft, Binary, or Text files to 
see if they are identical. 

D.BUG (page 20) gives you 11 new commands that proofread programs, trace 
program lines and variables as they are executed, find words and let you 
set up breakpoints for de-bugging your programs. 

D.BUG.DEMO demonstrates the capabilities of D.BUG. 

FP (ProDOS version of D CODE only) will remove the D CODE program (and 
any Applesoft program) currently in memory. Its function is basically the 
same as DOS 3.3’s FP command. Type ’’-FP’’ to execute. 


NOTES contains any changes or revelations that have occurred since this 
manual was printed. 





Getting Started - ,ri 1 

?„ r0 u« 0 D S COD C E°urL ProDOS. you can boo, Ihe D CODE disk by MN Si 
it in your main drive and turning on your Apple s power switch. Or > n '- b| 

ProDOS booted, type ”PR*6” from the keyboard. Or, if you re using ne , .L 

Apple, press CONTROL/OPEN-APPLE/RESET. 

Soon, the D CODE menu will appear— just type the number 
corresponding to the program you want to run or load: 

(1) COMPACT 

(2) COMPARE 

(3) D.BUG 

(4) D.BUG DEMO 

(5) NOTES (CHANGES TO MANUAL) 

If you already have ProDOS booted, you can skip the menu and simply type a 
hyphen followed by the name of the D CODE program you wish to see or 
use-STARTUP. COMPACT, COMPARE, etc. 

!£u are goinjno^use D CODE with DOS 3.3, dank ta. * D COW-* 
Instead, boot the DOS 3.3 System Master disk or whatever DOS 3_3 disk you 
normally would boot. Now insert the D CODE disk, type RUN S • 

and pick the pmgram you want to use from the menu Or - you car • gpe 
“BRUN” followed by the name of the util.ty.you wish to use. like COMPACT, , 

COMPARE or D.BUG. 

WhkhS’opmbne SnUmMDOS) you use is up to you: you’ll probably 
want bnase ,h?on« S>u”re used to. I, you don. know wh.ch y^u are «... 
type “CAT”. If you eel a disk calaloe, you’re using ProDOS. If you get > 

(Syntax Errot- message, you’re usioe DOS 3.3 (or you haven't booted, and 

therefore aren’t using any DOS). 


AND WE REPEAT (in case you've been asleep) 

Boot the D CODE disk ONLY if you are going to be using ProDOS. 
To use DOS 3.3 D CODE, boot a DOS 3.3 disk first. 



COMPACT 

D CODE’S COMPACT program allows you to reduce the amount of memory 
occupied by an Applesoft program, by optionally removing Rem statements, 
packing as many statements as possible into single program lines, and 
shortening variable names. 

COMPACT-PROGRAM ADVANTAGES 

1. A compacted program will occupy less space in memory. If, for example, a 
program won’t quite fit in memory under one of the graphics pages, 
compacting it might just squeeze it in. Or you may need more room for 
variables, more subroutines, etc. 

2. A compacted program will usually take up less space on disk. A DOS 3.3 
disk sector is 256 bytes long; a ProDOS block is 512 bytes. Sometimes an 
entire sector or block can be saved by eliminating just a couple of bytes. 

3. A compacted program will tend to run slightly faster (nothing that will 
knock your socks off, however). 

4. It just plain FEELS COOD to make a program as small as possible. This 
feeling, of course, depends on your own personal set of values (and how 
content your childhood was). 

COMPACT-PROCRAM DISADVANTAGES 

1. Compacted programs tend to be more difficult for humans to read. More 
statements per program line is one reason. Abbreviated variable names are 
another (bigger) reason. 

2. Without Rem statements, a program can be difficult to decipher, especially 
a couple of months down the road. 

3. After compacting a program, you may have some program lines that, due to 
their length, are uneditable, even with CPLE (Beagle Bros’ Global Program 
Line Editor), and especially with ancient cursor-tracing methods. The 
LINE.SPLITTER program (page 15) is a solution that pretty much scratches 
this problem off the list, however. 

PLAY IT SAFE 

Because of the disadvantages above, you should always LOCK your 
uncompacted program on disk, so you won’t accidentally SAVE the 
compacted version on top of it. Then Save your compacted version on disk 
under a new name. Your expanded version with its Rem statements and 
descriptive variable names might come in handy some day. In fact, now that 
you have the ability to quickly compact your code, you may want to use more 
Remarks and longer variable names to help in "pre-release" de-bugging. 
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1. Lock the program you vwrt Tt’tfv 

on disk so you don’t accidentally lose it. 


*\Y3(] 

,h! baiquaao 

2. LOAD the program you want to compact (type ’’LOAD PROGRAM-NAME )V 

3. BRUN COMPACT Oust type ’’BRUN COMPACT" with the D CODE disk in' 


D.BUG Note: If you want D.BUG and COMPACT both in memory, you must 
BRUN D.BUG first. Otherwise COMPACT will disappear. 


Now you will see COMPACT’S menu: 


(1) REMOVE REMS YES 

(2) CONCATENATE LINES YES 

(3) SHORTEN VARIABLE NAMES ... YES 

(4) RENAME VARIABLES YES 

(5) COMPACT PART OF PROGRAM . . NO 

(6) VARIABLE TABLE TO PRINTER . . NO 
(C) COMPACT 

(Q) QUIT 


You have six YES/NO options before compacting a program (the top four 
always start out as YES). You can toggle each option from YES to NO and 
back by pressing the number key indicated on the left. When you are ready, 
press "C” to compact the program. It won’t take long. 
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COMPACT Menu Options 


Here is an explanation of each COMPACT menu option: 

1. REMOVE REMS 

YES means that when you compact your program, every Remark statement 
wili be deleted. If you use a lot of Rems, this option will save more program 
space than any other, because every character and space in a Remark takes up 
an entire byte of memory. 

2. CONCATENATE LINES (computerese for "Connect Lines".) 

YES means that when you compact your program, as many statements as 
possible will be packed into single program lines, thus eliminating old line 
numbers. Sample program: 

10 TEXT: HOME 
20 COSUB 50 
30 PRINT “DOGFOOD" 

40 END 

50 PRINT CHR$(7) 

60 RETURN 

When these lines are concatenated, they look like: 

10 TEXT : HOME : COSUB 50: PRINT "DOGFOOD": END 
50 PRINT CIIR$(7): RETURN 

Every line number that is removed saves you a big four bytes of space. In this 
example, we saved 16 bytes. 

Technical Note: Applesoft needs an "overhead” of 5 bytes per line— 2 for 
the line number, 2 for a pointer to the next line, and 1 for a zero that ends 
the line. You lose one of the 5 bytes saved for the extra colon that separates 
the connected statements, leaving you with 4 saved for every line number 
eliminated. 

ULTRA-LONC-LINE PROBLEMS 

With option 2 set at YES, COMPACT will often create a program line that 
works perfectly, but is too long to edit. Applesoft allows program lines of 
about 250 bytes (each Applesoft word like "PRINT’ takes up one byte). 

Editing, however, has to consider each character in the listing (now “PRINT' 
takes up five characters, plus two more for spaces on each end). Even CPLE’s 
"Pack” feature (removes spaces from program lines) won’t always let you edit 
an ultra-long line. . 

WATCH OUT that you don’t inadvertently chop the end off of a program 
line when you attempt to edit it. If you are cursor-tracing a line and you hear 
beeping (or if you try to edit with CPLE and code is missing), type 
CONTROL-X immediately, and BRUN LINE.SPLITTER (page 15). 
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3. SHORTEN VARIABLE NAMES M e i noli 

When this option is set to YES, all variable names longer than two characters ^ 
will be shortened to two characters. For example: ‘ K1 


Old 

New 

‘•’C .' fl f 

* i ] 

NAMES$ 

NA$ 

ii, > 1 

NUMBER 

NU 


TABLE(NUM) 

TA(NU) 


WXYZ% 

WX% 



In Applesoft, it doesn’t matter how long your variable names are, only the first 
two characters count (COMPACT leaves only those two characters if you 
select YES for this option). The variables APPLE, APPALOOSA and AP are 
the same. So are MOUSES, MOUNTEVERESTS and MOS. The advantage to 
long variable names is that they are more descriptive. The disadvantage is that 
they take up a lot of room — one byte per character. 

Note: OPTION 3 simply chops the end off of long 
variable names. OPTION 4 actually renames variables 
without regard to their former names. 

4. RENAME VARIABLES 

When this option is selected, COMPACT will change as many two-or-more 
character variable names into one-letter names as possible. The multiple- 
character variables that are used most often will be converted to single letter 
names until all 26 letters have been used (for each variable type. Remember. 
AS, A% and A may all be in the same program). See the sample variable 
conversion table on page 13. 

Note: A (4) YES sets (3) to YES and (5) to NO. A (4) NO sets (6) to NO. 

5. COMPACT PART OF PROGRAM 

Use this option If you only want a portion of a program compacted. After 
typing “C” to start compacting, you will be asked for the start and end line 
numbers for compacting. You may default to the beginning or the end of the 
program by simply hitting RETURN as an answer to either question. 

A (5) YES sets (4) to NO. 

6. VARIABLE TABLE TO PRINTER 

When set to YES, this option will print the renamed variables on your slot 1 
printer (if option 4 is set to YES). See page 12 for details. 
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COMPACT options (continued) 



C. COMPACT 

Just type "C" to compact your program. After a brief pause (depending on the 
length of your program), a variable conversion table will be displayed if you 
selected option 4 (sample on page 13). When compacting is completely 
finished, you will see the former length of the program, the new length, and 
the amount of memory that was saved, all in bytes. 

OLD LENGTH : 4321 
NEW LENGTH s 3210 


BYTES SAVED: 1111 

Now that a compacted program has replaced your original program in ’ 

memory, SAVE it before you RUN it. (Since you’ve Locked the original 
uncompacted program on disk, you won’t accidentally Save the compacted 
version under the same name, will you?) You could name your compacted 
version with a suffix like ’’.C”. Now you will have the original program (like 
“TESTPROCRAM") and the compacted program (like “TESTPROGRAM.C"), 
both on the same disk. 

If you decide to ignore our advice and Save your compacted version with 
the same name as your original, there is no way the number of disk sectors 
will be smaller, unless you Delete the original version from the disk first. 

(DOS 3.3 only. ProDOS has eliminated this minor bug.) 

TO RE-RUN COMPACT 

After COMPACT has been used and exited, you will usually be able to bring it 
up again by typing "&" (return). If this doesn’t work, just type ‘‘BRUN 
COMPACT’ again. 
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EXTRA BYTES AT THE END OF A PROGRAM 

COMPACT assumes that any extra bytes that it finds imbedded beyond the .MO J ,'j 
end of a program is relocatable code that the program uses. If extra bytes are j;-J ; 
found, you will be asked if you wish to keep them. Answering "Y" will move , ( 
the code to the new program end. "N" will delete the extra bytes. 

If you don’t think you have anything beyond the end of the program, 
and COMPACT asks you about it anyway, just answer “N" and that will be the 
end of that. 

UNUSED STATEMENTS 

When programs have undergone heavy revision, statements often remain that 
can’t possibly be executed— your program Just won’t encounter them. 

COMPACT will report the line numbers that contain these potentially useless 
statements. It’s up to you to delete them after COMPACT is finished. 

UNUSED STATEMENT EXAMPLE: 

100 PRINT •HELLO' : GOTO 120 : PRINT "COOD-BYE" 

Here, "GOOD-BYE" will never be printed because of the GOTO statement 
Immediately before it. You could delete PRINT "GOOD-BYE" " and save 11 
more bytes. In this case, you would NOT want to delete the entire line. 

ANOTHER EXAMPLE: 

90 PRINT "DOGFOOD": COTO 110 
100 PRINT "IS FOR DOGS." 

1 10 PRINT " IS YUMMY WITH HOT SAUCE." 

Assuming no other statement in this program goes to line 100, COMPACT 
will tell you about it. You could delete line 100 (the entire line this time) and 
Save about 20 bytes. 

INTENTIONAL UNUSED STATEMENTS 
We like to use the following save-a-program trick: 

-1 COTO 10 

’2 PRINT CHR$(4);”SAVE PROCRAM NAME": END 
10 REM PROGRAM STARTS HERE 

The trick here Is that we can simply type "RUN2" anytime we want to Save 
the program without having to remember Its exact name. COMPACT will 
report line 2 as unused, even though we want to keep it. No problem; just 
don’t delete line 2. 
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When RENAME VARIABLES (option 4) is set to YES, a variable conversion 
table will be displayed on the screen during compaction. This chart lists the 
name of every variable in the program, it's new name (if it was changed), and 
the number of times it appears in the program. (Note: Only the first two 
characters of the variable will appear under the OLD column heading, even 
though that variable may have had a longer name.). 

One-character variables are listed first, unchanged, in the order of their 
appearance in the program. 

Next come the multiple-character variables. COMPACT will shorten as 
many of these as possible to one character, with the one* that appear most 
often in the program changed first. 

If no name appears in the NEW column, it’s because there are no more 
single characters left for that particular variable type. This will only occur in 
very large and/or complex programs. Usually real or string variables will be 
the first to run out of the 26 available single-character names. 

LOOK FOR ‘LONE’’ VARIABLES 

Watch the conversion chart for variables that appear only once or twice in a 
program. This could indicate that the variable name was misspelled or was 
once part of a program segment that was removed. You might be able to save 
additional space (or uncover a potential bug) if you look at the lone variable 
(use the FIND command in D.BUG, page 23). 
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OCCURRENCES 


OLD 

D 

L* 

B 

B* 

A%< 

L 

H 

C 

K 

Z 

J 

N* 

D* 

A* 

S* 

A 

X 

T* 

S 

T 

P( 

I 

BU 

FI 

EC 

LV 

SM 

YE 


NEW 


Single-ehanocter 
mriables art 
listed first, and 
will remain 
unchanged. 


»> 

**> 

= > 
-> 
■*> 

-> 


E- 

F 

G 

M 

N 

O 


Variables A, H, C 
& I) are already 
used, so the first 
multicharacter 
rariab/e is 
- converted to £. 


2 

6 

5 

8 

2 

14 
21 
4 

I— - 

8 

9 

15 
7 

72 

52 

95 

17 

20 

12 

9 

16 
94 * 
39 
19 


SAMPLE VARIABLE CONVERSION TABLE 
This table prints on the screen when COMPACT 
option 4 (Rename Variables) is set to YES. 


-Note: Only J occurrence may indicate an 
unnecessary for misspelled! tunable name. 


Variables are 
renamed without j y 
regard to their 
original names. 

Set option 3 to 
YES to simply 
shorten names. 


. End of old single-character variable names 

• The most -often used multi-character variable name 
is converted first. 


16 

14 

14 


BE 

«> P 


14 

CO 

-> Q 


13 

BP 

-> R 


12 

DF*< 

«=> A* 

First string-array 

1 1 

CD 

«> U 

Is named AS( JL 

11 

PN 

-> V 


10 

FD 

-> W 


10 

FI*< 

-> B* ( 


9 

PN* ( 

-> C*< 


8 

BL 

»> Y 


8 

IP 

• 


8 

ID 



8 

PR 



8 

PRX 

1 

V 

t 

• First integer 
variable is 

8 

8 

ID 


named A%. 

CF 



8 

ME* 

-> A*-*- 

- First string Is 
name AS. 

7 

i 

WD 
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COMPACT TIPS 

1. Before ^usirtg COMPACT, use D.BUG’s CHECK command (page 22) to catch 
any syntax errors in your program. 

2. Now that you don't have to worry about Rems eating your program space, 
use them to more-thoroughly document the development versions of your 
programs. Use longer variable names too— like COUNTER instead of CTR. 

Just remember that Applesoft only looks at the first two characters. 

3. To look for unused program lines without compacting a program, set all six 
menu options to NO. (Some minor changes might be made to your program.) 

4. To save even more space, RE-NUMBER YOUR PROGRAM BY l’s, using 
the Renumber feature from Beagle's Double-Take disk (ProDOS or DOS 3.3). 

COMPACT ERROR MESSAGES 

NO APPLESOFT PROGRAM IN MEMORY 

This means what it says. Load your program first, then BRUN COMPACT (or 
type “<£" if COMPACT is already loaded). 

MEMORY OVERFLOW. PROGRAM TOO LARGE 
This sometimes happens when you have other machine language program(s) 
in memory in addition to COMPACT. You may need to re-boot or take other 
measures to clear memory. 

RELOAD YOUR BASIC PROGRAM 

This message will occasionally come up when you’re going to compact a very 
long Applesoft program. Just re-load the program as instructed, and type ”& M 
to re-run COMPACT. 

In case you care: When you first BRUN COMPACT, it’s code Bloads at 
$4000 (16384 decimal), and then relocates itself just under HIMEM. If your 
loaded program extends above $4000, it will be partially wiped out by 
COMPACT and you’ll be told to re-load. 


There’s a COMPACT example on page 16. 
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LINE.SPLITTER 


LINE.SPLITTER simply chops a program line into two parts, in case it is too 
long to edit (see page 8). With your program loaded, simply type "BRUN 73/VIMGO 
LINE.SPLITTER” and, when asked, type the number of the line you want jo ^ ^ f 
split. LINE.SPLITTER will split the line as near the middle as possible, taking , . ^ 

into consideration any IF statements. 

The second section of the split line will be numbered one line number 

higher than the first section. 

LI NE.S PUTTER ERROR MESSAGES 
LINE DOES NOT EXIST 
Oops, try again. 

RENUMBER FOLLOWING LINE 

If the higher number is already taken, the split will be cancelled and you will 
have to renumber that part of your program to make room. (Use the 
RENUMBER option from our Double-Take disk, or do it "by hand” by cursor- 
tracing or by using GPLE's edit feature.) 

LINE CANT BE SPLIT 

The line has only one statement, or its first statement contains an IF. 


SAMPLE BEFORE: 

120 DIM SC<263) ,FI (255) l I - iiJ - 
1 i K - 1 i ML - 16384i M0 - 1740 
8 1 MM - 174001 PR - 17409i A “ 
liB - 2iC ■* 3lD ■ 4iF0 - 120 
IFF “ 255l TF - 256iL0C - 192 
00iQ - - 16304i QQ - Q + 1 6 1 

G* - CHR* <7>lD* - CHR* (4 
) iRT - 16 

130 PRINT "MEAT LOAF" 

SAMPLE AFTER: 

120 DIM SC(263) ,FI (255) i I » liJ - 
1 1 K - 1 1 ML - 163041 M0 “ 1740 
Bi MM - 174001 PR - 174091 A - 

1 1 B - 2lC - 3 

121 D - 4iF0 » 120i FF - 255iTF - 

256iL0C - 1920010 ■ - 16384 

iQQ ■ O + 16iG* " CHR* (7) I 
D* - CHR* (4) i RT - 16 
130 PRINT "MEAT LOAF" 15 

M 


COMPACT Example: 
Before: 


5 

8 

9 

10 
20 
25 
30 
50 

99 

100 
101 
102 

103 

104 

105 

106 

107 

108 

109 

1 10 
1 1 1 
1 12 

1 13 

114 

115 


After: 

5 
8 

10 


ONER# '' GOTO 50 

TEXT 

HOME 

READ NUMBER 
ALPHA* - CHR* 
PRINT ALPHA*j 
GOTO 10 
END 

REM DATA " 
DATA 68 i REM 


(NUMBER) 


DATA 

DATA 

DATA 

DATA 

DATA 

DATA 

DATA 

DATA 

DATA 

DATA 

DATA 

DATA 

DATA 

DATA 

DATA 


D 

46 i REM . 

66 i REM B 
B5i REM U 
71 i REM 
32 I REM 
701 REM F 
73i REM I 
78i REM N 
68 i REM D 
83i REM S 
32i REM SPACE 
66 1 REM B 
85i REM U 
71 i REM G 
83i REM 8 


Notice how COMPACT removes leading spaces 
in DATA statements. Trailing spaces not 
affected. 

Note: The READ AS command ignores 
leading spaces. You should use quote marks if 
uou want to keep the spaces. 

(Example: DATA- TRY-, m THIS m ) 


SPACE 


50 


50 


ONERR GOTO 
TEXT i HOME 
READ A« A* " CHR* 
A* ) i GOTO 10 
END i DATA 6B,46,< 
,70,73,78,68,83,: 
83 


OLD LENGTH l 
NEW LENGTH I 

310 

100 

BYTES SAVED i 

210 

(A) i PRINT 


6,85,71,32 

2,66,85,71, 
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COMPARE 


£332 FSSSSS?; 

exactly what lines ajc unique, . they are identical. 

COMPARE to check binary and text tiles to s 

ssiKr.rssss- 

quite well, however. So do COMPACT and D.BUG. 

When the COMPARE screen appears, enter the names of the two files 
RFT11RN (with no name) signifies the Applesoft 
you want to compare. RETUR ( lhc f,l e name and any 




X3T 

, 1 r ;•* ! 


(continued) 



Programs may look the same, but don’t be so sure. 
Use COMPARE to find subtle differences. 
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COMPARE (continued) 


COMPARING APPLESOFT FILES 

When you're comparing two Applesoft programs, COMPARE will ask you if 
you want occurrences of identical lines printed. You will usually want to 
answer “N", since "Y” will often print a ton of meaningless line numbers. 

During comparison, a 1, 2, D or S will appear next to the line numbers as 
they are shown on the screen: 

1 means that this line is unique to Program *1 (the first one you selected), 
and doesn’t exist in Program * 2 . 

2 means the line exists in Program *2 and not in #1. 

D means both programs have duplicate line numbers, but the contents of the 
lines are different. 

S means the lines are the same. (This will appear only if you answered "Y” to 
the DISPLAY SAME LINES? option.) 

COMPARING BINARY AND TEXT FILES 

Since there are no line numbers in binary and text files, COMPARE will just 
tell you if the files are identical or not. 

Binary File Note: If you’re using DOS 3.3, COMPARE will also display the 
starting address and length of both files. (If you’re in ProDOS, just type 
"CATALOG” and take a look there.) 

TO RE-COMPARE 

Once it’s loaded, you may usually re-enter COMPARE and use it again by 
typing (return). 
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D.BUG 
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LOADING D.BUG 

To load and activate D.BUC's commands, just type- 
BRUN D.BUG 

isrs^KSo. 

Tlke 'D P BUC°“ S i,“ d 7 H ^ 

REMOVING D.BUG 

ProDOS D CODE catalog.). This wiH W ^d SUcTS “*"* H' 6 ,he 
progmm in memory. If you’re in the habit of typing 
change your hab.t now. or you'll lose D.BUG every time. * 

F ,f ! G n L Si',5 HARACTER ABBREVIATIONS 

(“ C re r? 0 r e l7 ^the new^CHECK S* °? “» «*•«* 

C. CH CHE or CHPr t« f *• CHECK command can be abbreviated as 
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Fast Finder (page 22) 

New Command: FIND (F) 

Function: Quickly searches through an Applesoft program for 
specified character or word. 


'.i’v’.AKMOD W3K 
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Program Checker (page 24) 

New Command: CHECK (C) 

Function: Quickly proofreads Applesoft programs for syntax and undefined 
statement errors. In addition, everything you type from the keyboard is 
proofread automatically (no command required). 

Easy Lister (page 25) 

New Command: L 

Function: Saves you three keystrokes every time you list a program, by letting 

you type "L" instead of "LIST'. y n * 


New Commands: TRACE (T). NOTRACE (N). VARIABLES (V) and WINDOW ( W) 
Function. Lets you watch Applesoft program line numbers and statements 
live as they are executed (and optionally watch variable and expression 
values) In an adjustable text window at the bottom of the screen. 


Dump Tracer (page 32 ) 

New Commands: DUMP (D), SIZE (S) and ZAP (Z) 

Function: After a program stops for any reason, you can see the line numbers 
and statements that were most-recently executed. 


Breakpoints (page 34) 

New Command: BREAK (B) 

Function: Lets jxiuset up breakpoints so your program will automatically stop 
when a vanable becomes a certain value, or when other specified 
conditions are true. 


OS 


FAST FINDER (brun d.buc to toad) 

New Command: FIND (F) 

With any Applesoft program (and D.BUC.) in memory, type “F’ (return). You 
will be asked what you want to “SEARCH FOR:". After you respond, all line 
numbers containing your character or word will be reported. If your word 
appears in a line, say three times, that line number will appear three times. 
The total number of occurrences will be reported after the search ends. 

FIND scans your entire program twice, first looking for your string in 
PRINT, REM and DATA statements, and then in the form of Applesoft words, 
or tokens. When you tell FIND to search for "READ”, for example, it reports 
one set of line numbers for occurrences like PRINT “READ YOUR MAIL." and 
then another set of numbers for occurrences like READ A$. 

Drawbacks: While FIND will successfully find all occurrences of a 
variable like X. it will also throw in all occurrences of variables XX, YX, XY 
and MAX; strings like "FOX” and "Xebec", and so on. (Note: You can use 
GPLE's slower global search routine to locate variables only.) 

FIND won’t find parts of Applesoft keywords, like the CO in GOTO or the 
TURN in RETURN. For example, it won’t find the "HO” in line 10, but it will 
find it in lines 20 (twice) and 30 (three times). 

10 TEXT: HOME: NORMAL 
20 HO-3: SI 10=3: HBO-7 

30 PRINT “MELANIE’S OKLAHOMA HOME WAS HOT." 

WILDC@RD CHARACTERS 

Using “(a)" in a search word will match any single character in a string. For 
example, SEARCH FOR: D@G will find all occurrences of the words "DOG", 
"DICCER", "DACWOOD", "D3P0G”, and so on. 

Using in n search word will malcli anti number of characters. For 
example, "D^G" will lltul all occtmences of the words "DOG", "DOODLING", 
”IM; FOR /.-I TO 10: PRINT G", and "DEAFENING”. 

FIND AND LIST (FIND L or FL) 

Typing “FINDL" or“FL" works like "F* (above), but each occurrence will be 
Listed, and the search word will be highlighted in inverse. 

You will FIND some examples on the following page. 
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FIND Examples 
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SEARCH FOR: X ^ rt ;n 

(You type "FIND" (return) or “F" (return); "SEARCH appears on the icreen; you type “X" (return).) 

This will print the line number of every program line that contains the 
variable X or the character X. 

FL 

SEARCH FOR: AB 

This will find and list every occurrence of AB. For example, the variables ABC. 

CAB and XYZ79ABN and the strings ABBEY, RABBIT and CRAB. 

FL 

SEARCH FOR: POKE 4933@,0 

This will find and list every POKE of 0 into memory locations 49330 through 
49339, including POKE 49330,0; POKE 49331,0; POKE 49332,0; etc. 

FL 

SEARCH FOR: IF # THEN 100 

This will find and list all occurrences of "IF' followed by anything, and ending 
with ‘THEN 100", including such things as: 

IF A THEN 100 ’ ’ 

IF VAL(X$)”127 THEN 100 

IF PEEK(222)-255 OR C$-”COODBYE" THEN 100 




PROGRAM CHECKER (brun d.buc to load) 

New Command: CHECK (C) 

m With, any Applesoft program (and D.BUC) in memory, type "C" (return), and 
your 'program will quickly be proofread for two specific things: 

7SYNTAX ERRORS: This includes misspelled commands (like "PTINT"), 
improperly punctuated Applesoft statements (like "INPUT A/B") and 
type-mismatch errors (like A-’CAT" and AS-CAT). 

7UNDEFINED STATEMENT ERRORS: For example, a “COTO 100" statement 
when there is no line 100 in your program. 


Sorry Misspelled words inside quote marks (including DOS commands) and 
in REM and DATA statements will be ignored. CHECK will also not find 
’Illegal Quantity errors and the like. The COMPACT program will find 
program statements or lines that can’t possibly be executed (not really an 
error; see page 11). 


w.duij aocs not cancel improper statements, it just tells you about 
them Maybe your “eiror” was intentional -like a GOTO 100 when you hadn't 
typed in line 100 yet. After entering a program line that is improper, you 
should immediately edit, re-enter or delete the line. And speaking of editing 
D.BUC is totally compatible with GPLE (Beagle Bros’ Global Program Une 
Editor— see page 39). 

If you want to type a statement that contains an eiror, and you don’t 
want to see and hear D.BUG’s warning, precede the statement (and line 
number, if any) with a slash (•'/’’). The slash turns off D.BUC’s proofread 
function for that line only. 

ERROR MESSAGES 

No Errors: This means that the program in memory when you typed M C M is 
free of syntax and undefined statement errors. 

<?) An inverse “? in a listed program line or statement means a syntax 
error exists nearby. 


<*> An inverse in a listed program line or statement means an 
undefined statement error exists nearby. 

"LIVE” SYNTAX CHECKING 

With D.BUC loaded, every time you type anything, it will automatically be 
checked for syntax and undefined statement errors. Improper statements will 
be listed and flagged with an inverse "?” or 


t 
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EASY LISTER (BRUN D.BUC to load) ;<] 

New Command: L :wnmoDw 9 W 

With D.BUG loaded, you may simply type “I,” (return) to LIST the program in 
memory. All Applesoft syntax is in effect; therefore you can use commands/ 
like L10-100, U100 and L100-. 

GPLE Note: CPLE let’s you define anything to be typed by ESC plus one 
other key. GPLEs two-keystroke “ESC-L” List command won’t let you specify a 
line range (a disadvantage), but it does let you add other commands in front 
of LIST, such as TEXT and NORMAL (an advantage). 


( If I'd had D. BUG'S 
I one-character LIST 
command when l was a 
youngster, I'd have 
save d 41.255.650,210, 

244.315.065.535.650, 

210.244.115.065.535. 

650.210.244.315.065, 

535.650.010.244.315, 

065.535.650.210.244, 

315.065.530.650.210. 
994,513,566,735.455. 

266.444.315.265.535, 

650.210.244.415.065, 

535.650.210.244.315, 

065.543.252.333.244. 

315.065.535.650.210, 

244.335.064.535.650, 
210,244 keystrokes 

. by now. 
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WINDOW TRACER ( brun D.BUG to load) 

New Commands: TRACE (T) 

NOTRACE (N) 

^VARIABLES (V) 

WINDOW (W) 

Note: D.BUG's TRACE and NOTRACE replace Applesoft's versions of the same command. 

TRACE (T) (more details on pages 27-28) 

Typing “T" before you Run a program activates an adjustable-size “trace 
window" at the bottom of the text screen that displays line numbers and 
statements (and optional variable values) as they are being executed. You have 
the ability to slow program execution down or even execute one program line 
at a time. 

Hardware Note: Most Apple 11+ 80-column hardware (non-Apple brand) 
does not support windows. D.BUG's TRACE will still work, but 80-column 
screen layouts will scroll improperly. 40-column TRACE will work just fine. 

NOTRACE (N) 

Typing ‘N disables TRACE and related commands. 

VARIABLES (V:) (more details on page 30) 

With TRACE active, this command lets you specify which variable and 
expression values will be displayed in the trace window. For example you 
could type "V: X,Y,Z$” after typing “T" (for TRACE) to display values for those 
vanahles when the program is Run. Typing "V:" with no variables will turn off 
variable display. 

WINDOW (W) (more details on page 29) 

With TRACE active before a program is Run. typing “W” lets you pre-adjust 
the size of the trace window at the bottom of the screen. Press Return when 
finished adjusting. 

The trace window may also be adjusted during a TRACE (see page 28). 
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TRACE Command Details 


JMIW 


When you type “TRACE" or “T”, the 40 or 80-column screen will be divided aEfnmo ^ 
into two windows that can function independently. Normally the trace 
window is the bottom three lines of the screen: the top twenty lines remain 
for your program output (a line of hyphens takes one more line): 
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II 
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7 
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( 
7 
9 

9 

10 

11 
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n 

14 

15 
It 
17 
It 
19 
70 
21 
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21 
21 


Limitations: Because TRACE alters the screen's normal boundaries, your 
program's screen formatting may be slightly off (nothing as drastic as 
| Applesoft’s old TRACE, though). Graphics program tracing is limited to the 
four text lines at the bottom of the screen. You can't see the trace window at 
; all when you’re viewing page 2. 

If TRACE quits tracing and you haven't pressed a key, check your 
program; it might have a NOTRACE command in it. 


CHANGING TRACE SPEED AND WINDOW SIZE 
During a TRACE, you may use any of the commands on the next page to 
control the program’s speed or shut TRACE off completely. Any of the 
WINDOW adjustment commands on page 29 may be made while a program is 
tracing (no need to press “W" first, however). 


EXPERIMENT PLEASE 

As we. mentioned earlier. IT PAYS TO EXPERIMENT! To fully get the hang 
(pardon the expression) of all these commands, you need to play around with 
them— A few keypresses are worth 65,536 words. The following program is a 
good one to use to test TRACE’S commands and functions: 

10 FOR 1-1 TO 100 
20 PRINT I 
30 NEXT 

40 A-A+l: GOTO 10 

Type this program in, then type 'T' and “V: I, A". Now type “RUN" and try the 
speed-control keys (next page) and the window commands (page 29). 
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TRACE (continued) 

TRACE CONTROL KEYS 

The following keys may be used while your program is running (except while 

waiting for a G'ET or INPUT statement): 

Space Bar: When you press the space bar, your program will execute just 
one statement and wait for you to press the sp$ce bar again. If the trace 
window is active, you will see each command appear before it is actually 
executed. If you want, you can exit your program (with the usual 
control-C) before a command is performed. 

Return: After you’re finished single-stepping with the space bar, the 
RETURN key will restore normal-speed program execution. 

Left Arrow: Pressing the Left-Arrow (Backspace) key during a trace will slow 
down program execution to one of eight different speeds. 

Right-Arrow: Pressing the Right-Arrow key during a trace will speed a 
program up (assuming it has been slowed down). 

Button* 1 or Closed-Apple key: Pressing paddle/joystick Button # 1 or 
the Closed-Apple key (Ile/IIc only) will shut off the TRACE function to 
make your program execute more quickly (normal speed). 

Apple 11+ Note: You may also shut off TRACE by moving the trace 
window down off the screen with ctri-J (next page). 

Button *0 or Open-Apple key: Pressing paddle/joystick Button #0 or 
the Open-Apple key (Ile/IIc only) will restore the TRACE function to its 
full vim and vigor, windows and all. 

Control-C: Pressing CONTROL-C stops a program, as usual. 

Also.- You may use the Window Size keys (next page) during a TRACE. 
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WINDOW Command Details 
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Pressing "W” (after you have turned on TRACE with “T") will let you rnatyejQ 'T)AJ]T 
size adjustments to the trace window at the bottom of the screen. If youf ; - n j wo !lol 
program is already running and TRACE is active, you don’t need to press-*’Wr^ > n jjj, >v 
to use the Size Adjustment commands below. 

The trace window occupies the full width of the screen in either 40 or 80 
columns. An asterisk marks the division between the statement window and 
the variable window (see next page for variable tracing notes). 
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5 
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ASTERISK DIVIDES TRACE WINDOW 
(Mow with the comma & period keys.) 
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WINDOW SIZE ADJUSTMENTS 

Up-Arrow or Control-K: Pressing the Up-Arrow (Ile/IIc onTy) or ctrl-K 
(any Apple) will enlarge the trace vyindow upward, thus reducing the size 
of the program window. The trace window may (ill all but the top three 
lines of the screen. 

Down-Arrow or Control-J: Pressing the Down-Arrow (Ile/IIc only) or 
ctri-J (any Apple) will reduce the size of the trace window downward, 
thus enlarging the size of the program window. You may even reduce 
the trace window all the way off the screen to allow your program to 
execute normally. 

>: Pressing the comma key (shifted or not) will enlarge the size of the 
variable window from right to left 20 spaces at a time, thus reducing the 
space for traced line numbers and statements. 

< : Pressing the period key (shifted or not) will reduce the size of the 

variable window from left to right 20 spaces, thus enlarging the space for 
traced line numbers and statements. 
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VARIABLE Command Details 

Before a, program is Run (and after turning on TRACE), typing "V:” followed 
by one or more variables and expressions will make those variables’ values 
appear in the right section of the trace window (see WINDOW, previous page). 
Due t£ screen space limitations, only the first five characters of the variable or 
expression itself will be visible. If the variable value (or string) is longer than 
12 characters, it will also be truncated. 

Typing "V:" (note the colon) alone will cancel all variable tracing. So, of 
course, will a NOTRACE command. 

EXAMPLES: 

T 

V: X 
RUN 

“T" turns on TRACE so that line numbers and statements will be printed 
during execution. “V: X” says trace variable X too. "RUN” starts program 
execution. You may now use < . >. and the Up/Down arrows (or ctri-K/J) to 
adjust the size and arrangement of the trace window. 

T 

V: X, X+50, CHR$(N) 

RUN 

This command would trace the variable X, the expression X+50 and the 
character whose ASCII value is N. 

T 

V: 

RUN 

This command would trace line numbers and statements only. The "V:" 
cancels all variable tracing. 




VARIABLE ERRORS . 

Some expressions, like CHR$( -65) or 123/0, are impossible to interpret, so 5 3,0,rx ‘ 
they will produce an error message during a trace. 10 . 3n _° 

For example: V: X%, X%*256, CHR$(X%), NA$(X%) ‘‘ ' ‘ ^ 

This VARIABLE command could produce the following output in the variable " 
window. While X%“65, you might see: '•j'l 

X‘/. - 65 

X*/.#25 - 16640 

("'UID4: I m A 

NA*(X - NOW IS THE TIME 

While X%--1, you might see: 

X*/. - ~1 

X‘/.*25 - -256 

CHR* ( - ** ERROR ** 

NA#<X - #* ERROR ** 

Notice how the expressions are shortened— “CHR$(X%)" becomes "CIIR$(", 
etc. Also notice that some of the expressions have produced appropriate error 



Type "FP" any time you want to destroy D.BUG and all of its commands. 
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DUMP TRACER (BRUN D.BUGtoload) 


?> 


New Commands: DUMP (D) 
SIZE (S) 
ZAP (Z) 


VMi ' 
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DUMP (D) (more details on next page) 

After a program “crashes” at an error or stops for any reason, typing “D” will 
dump, or list, in order used, the last line numbers and statements that were 
executed. In effect, you can print a history of your program’s execution. 

If you follow “D” with a number, only that number of statements will be 
dumped. Typing “D12”, for example, would dump 12 statements. (Exceptions: 
See SIZE and ZAP.) 


SIZE (S) 

Typing “S” followed by a number (for example “S500”) will adjust the size of 
the dump buffer, letting it hold, in this example, 500 statements. The higher 
the number, the less memory you have available for other uses (each 
statement occupies only 2 bytes). 

SIZE will determine the number of statements dumped if you try to 
DUMP a number larger than the dump buffer. 

The minimum buffer size is 5 (accomplished by simply typing ”S”). The 
maximum is somewhere above 10,000 (100 is a more practical upper limit). 
The default, when you load D.BUG, is 50 statements (100 bytes). 

The SIZE command will CLEAR all of your variables. You will need to 
RUN your program again before you can do another DUMP. 

Technical Note: The dump buffer resides above HIMEM. When you 
change the buffer's size, HIMEM is adjusted accordingly. 

ZAP (Z) 

“Z“ will ZAP (clear) the dump buffer. 

IMPORTANT: You must ZAP the dump buffer if you want to type 
“RUN FILENAME” (a DOS command) followed immediately by a DUMP. 
Otherwise you’ll be looking at meaningless garbage. Typing ’’RUN” alone (an 
Applesoft command) automatically accomplishes a ZAP (for example, if you 
typed “LOAD FILENAME” and then “RUN”). A ZAP is also accomplished by 
adding, changing or deleting a program line, or using the SIZE command. 
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DUMP Command Details 

With your program (and D.BUG) loaded, type “RUN”. When the program 
stops, for any reason, type “D” to trace the last program lines and statements 
executed. If you don’t specify a number, the entire contents of the buffer will ' 
be dumped. If you want fewer or more statements dumped, include a number 
. after the D — like D3 or D2500. You can only dump as many statements as the 
dump buffer will hold (see SIZE, previous page). ’ ; f ? ) l 

If you want to capture a DUMP on your printer, type “PR*1” before you 
type “D”. 

. The trace buffer is automatically cleared when you make any changes to 
a program (add, delete or modify a line). Therefore a DUMP after a change will 
produce nothing. Always DUMP immediately after your program has been 
RUN and stopped. 

If you don’t want to clear the dump buffer when you RUN a program, 
type “RUN line*” instead of “RUN” (“line*” is your program’s first line). Now 
when you DUMP, earlier program Runs will be dumped first, with each 
separate RUN separated by a horizontal line. Just type “RUN” if you don't 
want earlier executions shown. 

DUMP CONTROL KEYS 

The following keys may be used during a DUMP: 

Left and Right-Arrows: The Arrow keys control DUMP direction. Pressing 
the Backspace key during a DUMP will start dumping backwards 
through the dump buffer— just in case you missed something. Inverse or 
flashing “R’s” will indicate Reverse dumping. Don’t attempt analysis of a 
program while dumping backwards (it’s confusing). Re-establish normal 
dumping with the Right-Arrow. 

Control-S: Pressing control-S during a DUMP will pause the display until 
another key is pressed. If you hit one of the direction keys during a 
p$use, the listing will continue in whatever direction has been specified. 

Space Bar. Pressing the space bar during a DUMP will step through the 
dump buffer one statement at a time. Any other key resumes normal 
speed. 

Control-C: Pressing controI-C exits a DUMP. 


BREAKPOINTS (brun d.buc to load) 


New Commands: 

y\y 
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BREAK IF... 
BREAK ON... 
BREAK AT... 
BREAK LIST 


BREAK+ 

BREAK- 


If you've ever been stumped by problems like "How did A$ get set equal to 
"ABC''?” or "When does that X variable get assigned the value 10000?" or 
"When does location 216 get Poked with a zero?”, you’re going to like the 
BREAK command. 

Typing “BREAK:" (or“B:") followed by a number, 1-8, and some 
instructions, tells your program to stop IF a specific condition is true, or ON 
the occurrence of a certain command, or AT the execution of a certain line 
number. 


BREAKPOINT DEMO 

Type in this little program so you can test some of the different types of 
D.BUC breakpoints on the following page: 


SAMPLE PROGRAM: 

5 TEXT: HOME 
10 X»INT(RND(1)*20) 

20 PRINT X 

30 IF X+2 THEN PRINT CHR$(7): COTO 10 
40 IF NOT INT(RND(1)*200) THEN 10 
50 PRINT "END": END 

SAMPLE BREAKPOINTS: 

Now type in the following sample breakpoint commands: 

Bl: IFX-10 
B2: ON COTO 
B8: AT 20,10 

The number after the "B" indicates the number of the break statement. Any 
number, 1 through 8 is allowed. 


bflODS- . 
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BREAK Command Details 
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BREAK IF... 5 r J 

The first sample breakpoint, “Bl: IF X-10” will cause a prognm.'when RUN, 
to stop any time X becomes equal to 10. When you Run the brogram several 
times, it will stop with the following message: / j 

BREAKPOINT 1: IF X-10 ^ ^ 

BREAK IN 20 u ‘ 

The first line tells you which breakpoint caused the break. The second line 
tells you the next statement executed after X was set equal to 10. 

Here are some other BREAK IF... examples (Remember, the number 
after the “B“ could be any number 1-8.): 

Bl: IF X-50 AND Y>50 would break any time X-50 and Y is greater than 50 
Bl: IF DF$-“DOG FOOD” would break any time DF$-”DOCFOOD” 

Note: The maximum size of a BREAK IF... or BREAK ON... statement is 32 bytes. 

BREAK ON... 

The second sample breakpoint (previous page), “B2: ON GOTO”, will stop the 
program on the first statement that begins with a COTO. 

Here are some other BREAK ON... examples that could be used to test 
other programs: 

B2: ON PRINT would break on any statement that started with PRINT 

B2: ON PRINT * would break on a statement like PRINT "HELLO*, but not 
on a statement like PRINT A$ or just plain PRINT. 

B2: ON IF X-25 AND Y-30 would break on any statement that started with 
“IF X-25 ANDY-30". 

B2: ON AND Y-30 would never break, because a statement cannot legally 
start with “AND”. 

B2: ON Y- would break the first time Y is assigned a value. 

Note: The maximum size of a BREAK IF... or BREAK ON... statement is 32 bytes. 

BREAK AT.. 

The third sample breakpoint (previous page), “B8: AT 20,10”, tells the 
program to stop at line 20 the 10th time a line 20 statement is encountered. 
(Again, the number 8 was used only as an example; any number, 1-8, is legal.) 

The “AT 20,10” actually means the 10th execution of any line 20 
statement. So if line 20 contained two statements, the program would break 
on the fifth encounter with line 20. A “Bl: AT 20” command (with no second 
number) would break the first time line 20 is encountered. 
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BREAK (continued) 

BREAK LIST (BLIST) 

Typing "BUST will list the breakpoints currently in memory, tike this: 
♦BREAKPOINT I: IF X-10 
♦BREAKPOINT 2: ON GOTO 
♦BREAKPOINT *8; AT 20,10 

ub. r a . *. )i , :: fom 

Typing "B2L.tST" vfould ,lir ( t .o.ply breakpoint 2: 

♦BREAKPOINT, 2:ON ( OOfTO 

Of Ieuu.1 A !:<i C. 

BREAK- 

The plus sign (+) next to each listed breakpoint (above) indicates that that 
breakpoint is active. A minus sign (-) indicates a breakpoint that is inactive; it 
will be ignored. To de-activate a particular breakpoint, like number 2, you can 
type "B2-". To de-activate all breakpoints, type “B-”. 


BREAK+ 

To re-activate a particular breakpoint, like number 2, you can type “B2+ M . 
Typing “B+" will activate all breakpoints. 

Note: Initially defining a breakpoint automatically activates it. 

REMOVING BREAKPOINTS 

You can erase a particular breakpoint by typing “B" followed by a number and 
a colon (like "B2:"). 
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BREAKPOINT Notes 


* ‘i 


CONTINUING AFTER A BREAK . '< 

You can usually use the Applesoft command "CONT" if you. wish to continue ■, 

running your program after a break. BUT, if your program stopped due .to a 
BREAK IF or BREAK ON condition, you will need either 
breakpoint or change the condition that caused tiie br^okj^Ollierw^je yo^'ViS 
got another break Coming immediately. For example, if your program Stopped 
because A~5, and you try to continue with A still equal to 3, 1 the program win -A 
immediately break again (because A still equals 5). You could use a direct 
keyboard command (don't change your program) to set A equal to some other 
value; then use CONT. 

Note: If you type a direct keyboard command with an error in it, you 
disable the CONT command. Don’t ask why; we don’t know. 

USING BREAK IN YOUR PROGRAMS 

Just like all D.BUC commands, breakpoints can be defined, activated and de- 
activated from within your Applesoft programs. 

PROGRAM SPEED 

BREAK IF breakpoints will often slow program execution considerably, 
depending on how many breakpoints have been specified, and their 
complexity. However. BREAK ON and BREAK AT will not slow a program 
down much at all. 


